home *** CD-ROM | disk | FTP | other *** search
/ MacWorld Secrets (3rd Edition) / Macworld Bonus CD, 6:96.iso / SECRETS Software Sampler / Dialog View 2.1.7 / Dialog View Manual / Dialog View Manual.rsrc / TEXT_1000_Main Manual.txt < prev    next >
Text File  |  1995-11-18  |  11KB  |  133 lines

  1.     
  2.  
  3.  
  4.  
  5. ¬©1990‚Äì1995 by James W. Walker.
  6.  
  7. Dialog View is a control panel that allows you to change the appearance of directory dialogs (Open and Save dialogs).  You can control what kind of icons are used, increase the height and width of the file list, and set the font for the file list.  It requires System 7.  Certain critical routines are accelerated for PowerPC.
  8.  
  9.  
  10. Preferences for an Application    
  11.  
  12. When you first install Dialog View, there is only one set of preferences, called ‚ÄúMost applications‚Äù.  You can create a new set of preferences that will apply to one specific application (or desk accessory) by choosing ‚ÄúNew preference set...‚Äù from the ‚ÄúPreferences for‚Äù pop-up menu.
  13.  
  14. Internally, applications are identified by application signature (also known as creator code) rather than by name.  For this reason, if you rename an application, or if the publisher changes the name of the application when they update it, the preferences will not be lost.  As an extreme example of the latter, TeachText and SimpleText have the same creator code, so they would share the same preferences.  On the other hand, a major upgrade sometimes involves a change in creator code.
  15.  
  16. In rare cases, you might want to create a preference set for a program other than an application or desk accessory.  (For example, MasterJuggler has the file type of an extension although it behaves in some ways like an application.)  By holding the option key as you select ‚ÄúNew preference set...‚Äù, you will be able to select any file.
  17.  
  18.  
  19. Icon options    
  20.  
  21. The choices available for icon display depend upon the version of system software on your Mac.  First let us discuss a plain System 7.0, 7.0.1, or 7.1.  Without Dialog View, directory dialogs display tiny generic icons.  By ‚Äúgeneric‚Äù I mean that the icons represent very general types of items, such as applications and documents, but do not distinguish between one kind of document and another.   If you set the Icons pop-up menu to ‚ÄúApple standard‚Äù, you will continue to see this kind of icon.  The menu item ‚ÄúTiny generic‚Äù is dimmed, because it essentially does the same thing as ‚ÄúApple standard‚Äù in this case.  If you set the Icons pop-up to ‚ÄúMedium + custom‚Äù, you will see icons that are a little larger, more specific, and in color if possible.  Choosing ‚ÄúLarge‚Äù produces full-sized icons, as you might guess.
  22.  
  23. If you are using System 7 with Macintosh Easy Open, or System 7.1 with System Update 3.0, then the ‚ÄúApple standard‚Äù option produces medium-sized color icons.  However, for some reason Apple neglected to handle custom icons.  (In case you are not familiar with the term, any icon that you change by pasting an icon into a Get Info window is a custom icon.  Application installers often create folders with custom icons.)  Choosing ‚ÄúMedium + custom‚Äù from the pop-up menu makes Dialog View step in to display custom icons, while Apple still draws most of the icons.
  24.  
  25. Fetching many color icons from the disk can slow things down.  Choosing no icons or tiny generic icons will yield the most speed.  The ‚ÄúMedium + custom‚Äù choice will be a bit faster if you have installed System Update 3.0 than if you haven‚Äôt.
  26.  
  27.  
  28. Enable Color and Gray    
  29.  
  30. System Update 3.0 enables directory dialogs to display color icons.  However, in some applications, the icons will actually appear in black and white.  Checking this option makes the icons use color in all applications (assuming you have a color monitor, of course!) and also ensures that dimmed text and buttons will use true gray rather than checkerboard-pattern gray.
  31.  
  32. Technical explanation: Directory dialogs in some applications are colorless because they lack 'dctb' resources.  The ‚ÄúEnable color and gray‚Äù option provides a standard 'dctb' for those dialogs that do not have their own.
  33.  
  34.  
  35. Suppress Dim Icons    
  36.  
  37. In ‚ÄúSave‚Äù dialogs, names and icons of files are dimmed.  Since you are not opening a file, you probably have little need to see the icons, so you may not appreciate the time it takes to draw the icons.  Checking ‚ÄúSuppress dim icons‚Äù replaces these icons with generic icons of the same size, which can be displayed much more quickly.  This option is only available if you have chosen ‚ÄúMedium + custom‚Äù or ‚ÄúLarge‚Äù in the Icons pop-up menu.
  38.  
  39.  
  40. Font Options    
  41.  
  42. With the ‚ÄúFont‚Äù and ‚ÄúSize‚Äù pop-up menus and the two bolding checkboxes, you can control appearance of the text used in directory dialog file lists.  If you wish, you can make folders or non-folders use boldface type.  A disk counts as a folder.  In U.S. systems, choosing ‚ÄúSystem font‚Äù gives you the Chicago font.  The size choice 0 is the default size for the system font, which will be 12 on U.S. systems.
  43.  
  44.  
  45. Stretching the File List    
  46.  
  47. If you check ‚ÄúStretch‚Äù, Dialog View can stretch directory dialog file lists to make them show longer names or more names.  It is usually necessary to stretch the whole dialog and move other items around to make room.  To control the amount of stretching, you specify the desired file list size and maximum dialog size, by clicking the ‚ÄúDrag‚Äù buttons and resizing the resulting windows.  Dialog View stretches directory dialogs according to these rules:
  48.  
  49. 1. Never shrink anything.
  50. 2. If the original height or width of a dialog already exceeds the maximum dialog size that the user specified, do not increase that dimension any more.
  51. 3. Try to stretch the file list part of the dialog to the optimum file list size specified by the user, if that can be done without violating rules 1 and 2.
  52.  
  53. Due to these rules, the actual size of the file list may end up either greater or smaller than the optimum size that you set in the control panel.  The ‚ÄúTry it!‚Äù button shows you the outcome for one particular type of dialog.
  54.  
  55. When you set the maximum dialog rectangle, remember that you are not specifying a typical dialog size; think of whichever of your applications has the biggest, most complicated directory dialogs.  On the other hand, you should not make the maximum dialog rectangle cover the whole screen; leave some leeway, say 50 pixels, at the bottom.  This is because some programs add items to the bottom of a dialog after Dialog View has done its work.
  56.  
  57. When stretching the list box, Dialog View tries to make the height a multiple of the height of each line, so that there will not be a fractional line at the bottom.  Unfortunately, when Apple software expects to draw color icons, it assumes that the line height will be 18 pixels, and adjusts the height of the list box accordingly.  In view of this, Dialog View will make the list height a multiple of 18, except when using tiny generic icons.
  58.  
  59.  
  60. Compatibility Notes    
  61.  
  62. Dialog View will not run in the presence of Norton Directory Assistance.
  63.  
  64. The control panel may crash in the presence of MenuFonts.  As a workaround, you could start up with MenuFonts disabled, configure Dialog View, and then restart again with MenuFonts back on.
  65.  
  66. The Delete dialog, the Links search dialog, and perhaps others, in Microsoft Excel have a conflict with stretching.
  67.  
  68. The MoviePlayer application from Apple has a conflict with stretching.
  69.  
  70. Dialog View should load before Default Folder or Aladdin‚Äôs Desktop Shortcut.  You can change the order using an extension manager, or by renaming something to change the alphabetic order.
  71.  
  72. Versions of the Metrowerks CodeWarrior compilers before 5.5 had an incompatibility with vertical stretching.  If you use these compilers, you should create preference sets for them in which you either uncheck ‚ÄúStretch‚Äù, or specify a relatively small value (say, 300) for maximum dialog height.  The HP DeskScan II application has a similar problem.
  73.  
  74. When you select a font beyond number 31, the little triangle in the font pop-up may be gray.  This is a harmless Apple bug.
  75.  
  76.  
  77. A Note to Programmers    
  78.  
  79. If you want your application to be compatible with the stretching aspect of Dialog View, obey three rules:  First, everything you draw in a directory dialog should be based on DITL items, not absolute positions.  Second, use separate DLOG/DITL resources for each distinct dialog, rather than trying to reuse things.  (For example, Apple‚Äôs MoviePlayer 1.0 used a dialog hook to hide some unneeded items, rather than just using dialog resources without the unneeded items.)  Third, do not use GetNewDialog to find dialog item positions before calling the Standard File package.
  80.  
  81.  
  82. Shareware Fee    
  83.  
  84. The shareware registration fee for Dialog View is US$10 per user.  When you register,  I will tell you (by e-mail if possible) how to turn off the weekly shareware reminders.  See the chapter ‚ÄúHow to Register‚Äù for more information.
  85.  
  86.  
  87. Distribution    
  88.  
  89. Dialog View may not be sold or offered for sale, or included with another software product offered for sale, except with the express written permission of the author.  The author‚Äôs failure to give permission promptly should not be taken as consent.   Companies that distribute public domain/freeware/shareware software for profit are expressly prohibited from distributing Dialog View.  This restriction does not apply to bulletin boards, commercial on-line services such as America Online, CompuServe and GEnie, and nonprofit Macintosh user groups which hold regularly scheduled public meetings.
  90.  
  91.  
  92. No warranty    
  93.  
  94. Dialog View uses some undocumented techniques.  Use it at your own risk.  I will attempt to fix any bug that I can duplicate on my own machines, but will not buy other people‚Äôs software for compatibility testing.  It is possible that some future release of Apple system software (such as, say, Copland, AKA System 8) will render Dialog View either obsolete or hopelessly incompatible.
  95.  
  96.  
  97. Author‚Äôs Address    
  98.  
  99. I can be reached by e-mail at the following addresses.
  100.  
  101. America Online: JWWalker
  102. Internet: jwwalker@kagi.com
  103. CompuServe: 76367,2271
  104. WWW: <http://members.aol.com/jwwalker/>
  105.  
  106.  
  107.  
  108.  
  109.  
  110.  
  111.  
  112.  
  113.  
  114.  
  115. Other software by this author    
  116.  
  117. Shareware:
  118.  
  119. ‚Ä¢ OtherMenu, a hierarchical menu extension which can be used for navigating directory dialogs as well as file launching and other utility functions
  120. ‚Ä¢ Carpetbag, which opens fonts, sounds, FKEYs, etc.
  121.  
  122. Freeware:
  123.  
  124. ‚Ä¢ Text Capture FKEY, which lets you copy otherwise uncopyable text to the clipboard
  125. ‚Ä¢ Text Editor Patches, which can add various feature to applications
  126. ‚Ä¢ PrintAid, next best thing to a spooling printer driver
  127. ‚Ä¢ Alias Dragon, restore drag-and-drop function to cross-volume application aliases
  128. ‚Ä¢ Reference Link, hot-links most any editor to THINK Reference
  129.  
  130.  
  131. Acknowledgements    
  132.  
  133. Thanks to those who beta-tested version 2.0, including David Ameeti, Steve Bobker, Steve Kalkwarf, Susan Lesch, Mark Nagata, Ari Weinstein, Kimo B. Yap, and many others.  Susan Lesch also gave me considerable help with the user interface design.